'\"macro stdmacro
.\"
.\" Copyright (c) 2000-2004 Silicon Graphics, Inc.  All Rights Reserved.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\"
.\"
.TH PMSOCKS 1 "PCP" "Performance Co-Pilot"
.SH NAME
\f3pmsocks\f1 \- shell wrapper for performance monitoring across firewalls
.SH SYNOPSIS
\f3pmsocks\f1
\f2path\f1
[\f2args\f1 ...]
.SH DESCRIPTION
.B pmsocks
allows Performance Co-Pilot (PCP) clients running on hosts
located on the internal side of a TCP/IP firewall to monitor
remote hosts on the other side of the firewall.
This assumes the firewall has been configured
with a compliant
.B sockd
daemon and the necessary access controls are satisfied.
.PP
.B pmsocks
is a thin shell wrapper around the
.BR tsocks (8)
library using the
.BR tsocks (1)
utility, which are not included with PCP.
You can obtain
.B tsocks
from
.BR https://tsocks.sourceforge.net/ .
.SH FILES
.TP 5
\f2/etc/tsocks.conf\f1
configuration file for the
.BR tsocks (8)
library.
.SH SEE ALSO
.BR pmcd (1),
.BR pmproxy (1),
.BR PMAPI (3)
and
.BR tsocks (8).
